home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 12 / Cream of the Crop 12 (Part II) / Cream of the Crop 12 (Part II).iso / OS2 / SAMBA193.ZIP / readme.os2 < prev    next >
Encoding:
Text File  |  1996-04-18  |  5.5 KB  |  167 lines
  1. Samba 1.9.15p8 for OS/2  release 3 :  REQUIRES emx 0.9b.
  2.  
  3.  
  4. Please read the file README, which contains general information about
  5. the configuration and use of Samba.
  6.  
  7.  
  8. Notes specific to OS/2 port:
  9. ============================
  10.  
  11. Filenames have been shortened to 8.3 in case anyone is using FAT.
  12. Files affected are:
  13. smb.conf  -> smb.cfg          smbclient -> smbclnt.exe
  14. smbstatus -> smbstat.exe      nmblookup -> nmblook.exe
  15. smbpasswd -> smbpass.exe
  16.  
  17. As I only use HPFS, I can't guarantee this will work on FAT systems,
  18. although I have tried to stick to 8.3 filenames.  I have noticed some
  19. temporary files being created with long filenames by smbd when I tried
  20. printing (which does not work yet anyway).  nmbd will not be able to
  21. create browse lists on FAT systems, as it uses temporary files with
  22. long file names.
  23.  
  24. smb.cfg should be in the directory smbd is started from.  The path to
  25. smb.cfg is a compile time option, so if you are compiling from source
  26. you can set this to an absolute path to remove this restriction.
  27.  
  28. User home directories not supported.  This doesn't make much sense on
  29. OS/2.  I haven't actually disabled anything, so if you try setting
  30. this up, behaivour is undefined.
  31.  
  32. Password support is incomplete (I have found a crypt() routine, but 
  33. lack of passwd file support in the EMX libraries make support difficult
  34. without major changes).  Setting a password server may work.
  35.  
  36. Printing does not appear to be working.  The output of OS/2's lpq seems
  37. to depend on the print server and may differ from the versions of lpq
  38. already supported by samba.
  39.  
  40. Make sure you have a \tmp directory on the drive you run from, as samba
  41. expects all Unix systems to have /tmp.
  42.  
  43. You must have a "SET HOSTNAME=<hostname>" line in your config.sys
  44.  
  45. Included Files
  46. ==============
  47.  
  48.  
  49. README         README file from Samba distribution
  50.  
  51. README.OS2     This file
  52.  
  53. smbd.exe       Samba server - provides LanManager style file and print
  54.                services.
  55.  
  56. nmbd.exe       Netbios (rfc1001/1002) nameserver
  57.  
  58. smbclnt.exe    Command-line client for accessing PC disks and printers.
  59.  
  60. nmblook.exe    Netbios name lookup.
  61.  
  62. testparm.exe   For testing config file.
  63.  
  64. manpages       smbd.txt, nmbd.txt, smbrun.txt, smbstat.txt, smbclnt.txt
  65.                clitar.txt, testparm.txt, testprns.txt
  66.  
  67. samba.faq      The Samba FAQ
  68.  
  69. samba.txt      General manpage for the whole suite.
  70.  
  71. config.txt     Manpage for smb.cfg (config file)
  72.  
  73. examples/      Sample smb.cfg files
  74.  
  75. patches.os2    Patches needed to compile the 1.9.16p8 source with EMX 0.9b
  76.  
  77. makefile.os2   Makefile with minor alterations to make it easier to compile
  78.                under OS/2
  79.  
  80.  
  81. Included but untested:
  82. ======================
  83.  
  84. clitar.exe     tar extension to smbclient for backing up PCs.
  85.  
  86. testprns.exe   For testing printer setups.
  87.  
  88. smbos2.exe     Wrapper for running programs from smbd (added after it was
  89.                pointed out that samba often passes filenames with full paths
  90.                in Unix style (eg /tmp/file) as arguments).
  91.  
  92. smbstat.exe    Show status of smbd.
  93.  
  94. smbpass.exe    To do with passwords - probably not much use under OS/2.
  95.  
  96.  
  97. Source, and more documentation, is available from the Samba WWW site :
  98.  
  99. http://lake.canberra.edu.au/pub/samba/
  100.  
  101. EMX 0.9b is available from hobbes.nmsu.edu, ftp.cdrom.com, ftp.leo.org and
  102. other OS/2 FTP sites.  emxrt.zip contains the required libraries.
  103.  
  104. Bugs:
  105. =====
  106.  
  107. Known problems:
  108. ===============
  109.  
  110. Printing does not work.  I have tried using REXX scripts with path info
  111. built in, and watched the processes startup properly but nothing comes
  112. out of the printer (remote via lpr in this case).
  113. If you can get it going, please let me know how you did it.
  114.  
  115. Temporary files are created with long filenames (when printing, and updating
  116. browse list)
  117.  
  118. Backspace deletes two chars after a '\' is entered in smbclnt.
  119.  
  120.  
  121.  
  122. Bug reports for the OS/2 port should be sent to Jason Rumney <jasonr@pec.co.nz>.
  123.  
  124. Change log:
  125. ===========
  126.  
  127. * Changes from release 2 to release 3.
  128.  
  129. Samba no longer has the restriction of only being able to access files on
  130. the drive it is run from.
  131.  
  132. Commands that formerly redirected output to /dev/null should now redirect
  133. to NUL instead.
  134.  
  135. smbrun removed, as it was all to do with running permissions which are
  136. meaningless under OS/2.  smbos2 included as an optional wrapper to translate
  137. paths (turn /'s into \'s).
  138.  
  139. smbdf.cmd included (I wrote this a while back but forgot to include it before)
  140. add the following line to smb.cfg to use it (warning: it is quite slow)
  141.         dfree command = smbdf.cmd
  142.  
  143. * Changes from release 1 to release 2.
  144.  
  145. nmblookup (nmblook.exe) is included, and works.
  146.  
  147. An attempt at password support was made using the gnuufc crypt routines,
  148. but then I found that a lot of functions in the EMX libraries to do with
  149. passwd files don't actually do anything.
  150.  
  151. Browse lists should now work if you use HPFS and set your lock directory
  152. to an absolute pathname.
  153.  
  154. Thanks and Goodbye
  155. ==================
  156.  
  157. Thanks to those of you who have provided feedback, and helped find bugs.
  158. As I will soon be switching to Windows 95 (by necessity, not choice so
  159. no flames please :-) I will no longer be able to work on Samba for
  160. OS/2.  Hopefully someone else will be able to pick it up and bring it
  161. to the same level as the Unix version.  Don't forget to send any
  162. patches to Andrew Tridgell (samba-bugs@anu.edu.au) so they will get
  163. included with the general release (use conditional compiles for OS/2
  164. specifics).
  165.  
  166.     Jason Rumney (jasonr@pec.co.nz)
  167.